/*
    This file is part of the substandard lisp implementation of Standard Lisp
    Copyright (C) 2011 Nicky Nickell

    substandard lisp is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/

std_help = (a, env) ->
  topics = a[0]

  if topics.length is 0
    return array_to_list (new lisp_id topic, env.oblist for topic of lisp_docs)
  else
    return array_to_list (new lisp_string (if topic.value of lisp_docs then lisp_docs[topic.value] else "no help for #{topic.value}") for topic in topics)
    return array_to_list ((if topic.value in lisp_docs then (new lisp_string lisp_docs[topic.value]) else "no help for #{ topic.value }") for topic in topics)

/*---
name: help
arity: 0
rest: true
ftype: FTYPE_EXPR

argument-types:
  - TYPE_ID

argument-names:
  - TOPICS

doc: >
  if TOPICS is not provided, help returns a list of the id's for which there is
  help information; otherwise, help returns a list composed of the help 
  information for each element of TOPICS.
...*/
